DiscSpace 1.17 (17-Dec-2002)

Purpose:     Display of graphical disc usage statistics for directories
Author:      Martin Wrthner
Runs under:  RISC OS 2 or higher (latest versions not tested under RISC OS 2)
             Supports RISC OS 3 image files and DragASprite
             StrongARM compatible
             Supports RISC OS 4 E+ discs with long filenames
             32-bit compatible
Status:      FREEWARE (see below)

Have you ever wondered where all the free space on your hard disc has
gone? Do you want to know which directories consume most of your hard
disc space without having to count each directory using the filer?

This application shows a diagram of disc usage, displaying a bar for
each directory. The whole directory tree is cached so you can open
subdirectories similar to using a filer window.

How to use it
-------------
The main menu item 'Count' leads to a standard RISC OS save box. Drag
the 'filer window icon' to the directory you are interested in (e.g.
the root directory of a drive).
 You may also simply drag a directory to the icon bar icon of the
application. This is the easier way as long as you don't want to
scan the root directory of a drive.
 For the ultimate ease of use, DiscSpace also allows you to drag the
icon bar icon itself. Note that you can do this with Adjust which
prevents DiscSpace from opening its main window first (if you have
already done a scan before).
 DiscSpace scans the directory and all its subdirectories displaying
some kind of FilerAction window (offering the menu options 'Faster'
and 'Verbose' like the real FilerAction window). Note that counting
may take some time if the chosen directory is a top-level one.

Having finished the 'Count' operation, DiscSpace displays a window
which shows a 'Total' bar for the whole directory and a bar for each
subdirectory indicating how much disc space it consumes. By
double-clicking on a subdirectory, it is opened and the window is
replaced by a display of the corresponding subdirectory. By chosing
'Open parent' from the menu or by Adjust-clicking on the Close icon
or by Adjust double-clicking anywhere inside the window, you can go
up one level in the directoy tree (but no further up if yor are at
your starting directory, in this case you will hear a beep).

By default files are not shown in the window. Instead, there is one
item which shows how much space all the files in the directory consume
together. If you double-click on this item or choose 'Show files' from
the menu, this item is replaced by one item for each file in the
directory. Double-clicking on any of these file icons or choosing
'Show Files' again switches back to the original display mode. By
choosing 'Open filer' from the menu, a filer window on the currently
displayed directory is opened. Please note that expanding the single
representative for all files may take some time as the directory on
the disc is scanned. In particular, this is true if the directory is
within an archive and you use SparkFS with the 'Images' option (see
below) on.

Choose 'Rescan' from the menu to have the directory scanned again
(useful if you have deleted objects in the meantime).

The main menu item 'Images' determines whether DiscSpace also scans
the directory trees of image files (DOSDisc files or archives when
used with !SparkFS). If it is not ticked, images are treated as files.
The displayed size of an image file is always the size of the file
(not the sum of the sizes of the objects inside the image). So for a
DOSDisc image, the overall size usually differs from the sum of the
sizes of the objects inside (as there may be unused space inside the
image).

DiscSpace uses outline fonts wherever possible (i.e. for all icons
and menus). If you do not want this feature or if your version of the
WindowManager already uses outline fonts instead of the system font,
you may switch it off by making the following change in the !Run file:
Change the line
  Set DiscSpace$UseFont TRUE
to
  Set DiscSpace$UseFont FALSE

If the application is used on a RISC PC (i.e. under RISC OS 3.5 or
higher), this option is set to FALSE automatically.

You may change the font to be used and its size by modifying the
lines:
  Set DiscSpace$Font ...
  SetEval DiscSpace$FontWidth ...
  SetEval DiscSpace$FontHeight ...
to suit your own taste. Note that if the font is not found, the
application reverts to using the system font.

If you want the 'Image' option to be unticked after loading DiscSpace,
then make the following change in the !Run file:
Change the line
  Set DiscSpace$Images TRUE
to
  Set DiscSpace$Images FALSE

History
-------

1.20 (17-Dec-2002):
  - first 32-bit compatible release, otherwise identical to 1.16
1.16 (16-May-2001):
  - increased buffer size for file names, now copes with file names
    up to 235 characters
1.15 (21-Mar-2001):
  - corrected condition for using 64 bit computations, so computations
    that fit in 32 bits are more accurate - also avoids very rare
    division by zero crashes caused by inaccuracies with very small
    overall sizes
1.14 (11-Jul-2000):
  - 64 bit values are now used for size computations instead of
    32 bit values, so the program copes with discs larger than 2GB
    (previous versions displayed nonsense values in that case)
1.13c (19-May-2000):
  - corrected templates for use with "outline fonts in icons"
    feature under RISC OS < 3.5 (led to error)
1.13b (19-Mar-2000):
  - slightly changed documentation
1.13  (13-Mar-2000):
  - supports unlimited number of files in directory and
    unlimited length of filenames
  - displays the number of objects present in the directory
  - allows Images option to be configured in !Run file
  - international support via Messages file
  - WWW button in info window
1.12  (28-Nov-1996):
  - dragging icon bar icon works as a short-cut
1.11  (09-Oct-1996):
  - StrongARM compatible
1.10 (23-Jun-1996):
  - when an error occurs while counting (e.g. Broken
    directory), counting is not aborted
1.09b (10-Jun-1995):
  - Adjust double-click on the window can be used
    instead of Adjust closing the window (open parent)
    (suggested by Sergio Monesi)
1.09 (31-Jan-1995):
  - Sorry, forgot a file in 1.08 (Templates3)
  - also forgot to change the Templates after a major
    library revision (changed the way fonts in icons
    are handled)
1.08 (26-Jan-1995):
  - minor bug fix
1.07 (19-Dec-1994):
  - contains code to work around a small bug in ArcFS 2
    (still present in current version which is 0.71)
1.06 (23-Aug-1994):
  - accepts a directory dragged to the icon bar
  - contains sprites for iconised windows
1.05 (17-Aug-1994):
  - switches UseFont off if run under RO 3.5 or higher
  - contains style guide compliant templates (RO3 only)
1.04 (10-Feb-1994):
  - fixed bug:
  - Rescan took the currently displayed directory
    as starting directory for the scan instead of
    the previous starting directory
1.03 (05-Feb-1994):
  - first version sent to Hensa

To do
-----
- allow multiple windows (like the filer)
- allow multiple directory trees
- include options to count only files after a certain date,
  only certain file types, not to count applications, etc.
- extend 'Images' option to allow the user to select which kinds
  of images should be scanned and which should not
- proper configuration options

Copyright message
-----------------
This application, DiscSpace, is  Martin Wrthner, 1994-2001 and is FREEWARE.
This means that you may copy it freely provided that
(a) all files of this application are distributed together without
    modification (apart from adapting the !Run file as described above)
(b) this application is not sold for profit without my explicit written
    permission (this includes distribution on CD)

You can contact me at:

Martin Wrthner
Mannheimer Str. 18
67655 Kaiserslautern
Germany

Phone: +49-(0)631-3608205
Fax:   +49-(0)631-3608203

e-mail: martin@mw-software.com
WWW:    http://www.mw-software.com/
